home *** CD-ROM | disk | FTP | other *** search
/ AMIGA-CD 1 / AMIGA-CD Vol 1.iso / most / most.dok < prev    next >
Text File  |  1994-10-01  |  35KB  |  1,172 lines
  1.                       Dokumentation zu Most V1.56
  2.  
  3.                          Datum: 23. April 1994
  4.  
  5.                             Autor: Uwe Röhm
  6.  
  7.       Most ist ein Textanzeiger ähnlich Less, More oder MuchMore.
  8.  
  9.    Most bietet
  10.  
  11.    -     beliebig viele Textfenster
  12.  
  13.    -     verteiltes Prozeßsystem
  14.  
  15.    -     Suchfunktion
  16.  
  17.    -     frei konfigurierbar
  18.  
  19.    -     Kopiermöglichkeit ins Clipboard
  20.  
  21.    -     Einladen von Dateien per Doppelklick
  22.  
  23.    -     Fontsensitive Oberfläche
  24.  
  25.    -     PubScreen, eigenen Bildschirm oder Workbench
  26.  
  27.    -     AppWindow, AppIcon
  28.  
  29.    -     ARexx Unterstützung
  30.  
  31.    -     Sprachanpassung per locale.library
  32.  
  33.    -     XPK Unterstützung
  34.  
  35.    -     Verwendung mit Pipes
  36.  
  37.    -     Hilfe per AmigaGuide
  38.  
  39.    -     benötigt Kickstart 2.0 oder höher!
  40.  
  41. Most V1.56
  42. **********
  43.  
  44.                       Dokumentation zu Most V1.56
  45.  
  46.                 Datum: 23. April 1994  Autor: Uwe Röhm
  47.  
  48. Copyright
  49. *********
  50.  
  51.    Am Anfang standen Schweiß und Mühe. Also sprach der Programmierer:
  52. Es werde Giftware! Und so war es.
  53.  
  54.    Most 1.56 ist Giftware und darf frei kopiert und benutzt werden. Ich
  55. würde mich aber über Geschenke jeglicher Art von den Benutzern, die
  56. Most regelmäßig verwenden, sehr freuen.
  57.  
  58.    Davon abgesehen behalte ich mir mein Copyright aber vor, also:
  59.  
  60.                    Copyright (C) 1992/93/94 Uwe Röhm
  61.  
  62.    Ich verbiete ausdrücklich, daß Most kommerziellen Produkten ohne
  63. meine Zustimmung beigelegt wird. Insbesondere darf Most nicht für
  64. militärische Zwecke im weitesten Sinne verwendet werden. Im weitesten
  65. Sinne heißt, daß ich auch den Verwaltungen und sonstigen Büros
  66. solcher Firmen die Verwendung untersage, die militärische Produkte
  67. auch nur planen oder unterstützen (Hersteller sowieso).
  68.  
  69.    Most darf in PD Sammlungen aufgenommen werden, solange jene nicht
  70. mehr als umgerechnet 10 DM kosten. Das ist das absolute Maximum! Ich
  71. verlange aber, daß Most immer vollständig, also insbesondere immer
  72. zusammen mit der Dokumentation verbreitet wird. Das gilt auch für
  73. jeden normalen Benutzer! Leute, denkt an die Doku - ohne die ist ein
  74. Programm nur die Hälfte wert!
  75.  
  76. Prinzip
  77. *******
  78.  
  79.    Ich habe Most geschrieben, da ich eine Textanzeiger haben wollte, der
  80. auf der Workbench aufgeht und sowohl über die Tastatur als auch die
  81. Maus vollständig zu bedienen ist. Außerdem sollte er möglichst
  82. flexibel sein und insbesondere auch mit wenig Speicher auskommen.
  83.  
  84.    Deshalb arbeitet Most immer mit einem Fenster, in dem der Text
  85. angezeigt wird. Wer will, kann jenes aber auch auf anderen Bildschirm
  86. öffnen lassen. Most kann sogar einen eigenen Bildschirm öffnen.
  87. Wieviele Fenster Most auf hat, wo jene liegen (welcher PubScreen) und
  88. welche Texte darin zu sehen sind hängt nur vom Speicher und dem
  89. Benutzer ab :-)
  90.  
  91.    Jeder Text hat nicht nur sein eigenes Fenster, sondern dahinter
  92. steht auch ein eigener Prozeß. Damit sind die Textfenster voneinander
  93. völlig autonom.  Insbesondere können ARexx Befehle an verschiedenen
  94. Texte gleichzeitig gesendet werden und es ist immer möglich, neue
  95. Fenster zu öffnen, auch wenn die bereits geöffneten gerade
  96. "beschäftigt" sind. Dazu gibt es einen Most Hauptprozess, der die Texte
  97. verwaltet und einige globale ARexx Befehle behandelt (see Der ARexx
  98. Port).
  99.  
  100.    Um den Speicherverbrauch unter Kontrolle zu haben, arbeitet Most
  101. immer mit einem Puffer. Kleinere Texte, die vollständig in den Puffer
  102. passen, werden in einem Aufwasch eingelesen. Als Nebeneffekt wird die
  103. Textdatei nun nicht mehr benötigt und kann z.B. sofort weiter
  104. verändert werden.  Zu große Texte werden pufferweise gelesen. Das
  105. spart Speicherplatz (man wähle kleine Puffergrößen), bringt aber
  106. weniger Komfort (sprich Zeiteinbuße) beim Scrollen und Suchen.
  107. Außerdem blockiert Most nun den Text, so daß er nicht verändert
  108. werden kann, solange Most in anzeigt.
  109.  
  110.    Dieses "Paging" großer Dateien ist sehr nützlich, wenn man wenig
  111. Speicher oder übergroße Dateien hat. Wer es nicht haben will braucht
  112. nur die Puffer- größe sehr sehr groß machen (sagen wir mal 4 MB),
  113. womit wohl alle normalen Textdateien auf einen Schwung einlesbar sind.
  114. Keine Angst, Most verwendet dann natürlich nur soviel Speicher, wie
  115. die Datei groß ist :-))
  116.  
  117.    Eine Ausnahme des Pagings sind XPK-gepackte Dateien, die der
  118. Einfachheit halber immer vollständig eingelesen werden. Für sie gibt
  119. es also kein Paging! (see XPK Schnittstelle)
  120.  
  121.    Natürlich kann Most Texte mit allen ANSI-Steuersequenzen anzeigen.
  122. Dafür habe ich das Rad nicht noch einmal erfunden, sondern auf
  123. Bewährtes zurückge- griffen: Das console.device. Als Nebeneffekt kann
  124. man Textstellen markieren und in das Clipboard kopieren. Leider hat
  125. dies auch drei Nachteile:
  126.    -  Man kann nur innerhalb der sichtbaren Seite markieren
  127.  
  128.    -  Das Scrollen ist auf Amigas ohne 680x0 (x >=2) relativ langsam ;-)
  129.  
  130.    -  Binäre Dateien sollte man NICHT einladen. Das gibt Chaos....
  131.  
  132. Konfiguration
  133. *************
  134.  
  135.    Most konfiguriert sich in der Reihenfolge
  136.  
  137.   1. Interne Vorgabewerte
  138.  
  139.   2. Environmentvariablen Most/Most und Most/FileReq (Bei Aufruf in
  140.      einer Shell werden lokale Variable zuerst eingelesen)
  141.  
  142.   3.      Bei Shell-Start: Shellparameter auswerten
  143.           Bei WB-Start   : Icon-Tooltypes auswerten
  144.  
  145.   4. NEU seit Most 1.53: Zu jedem Text wird - sofern vorhanden - dessen
  146.      Icon geöffnet und die Tooltypes ausgewertet. Die darin stehenden
  147.      Werte gelten dann lokal für das neue Fenster. Außerdem können
  148.      hier (und nicht im Most-Programmicon!) auch alle ARexx-Befehle
  149.      direkt eingetragen werden. Diese werden dann ebenfalls der Reihe
  150.      nach ausgeführt, quasi als eine Art "Tooltype-Skript" (see Der
  151.      ARexx Port).
  152.  
  153.    Folgende Optionen sind jeweils in 2.), 3.) und 4.) erlaubt:
  154.  
  155. FILES
  156. =====
  157.  
  158. Verwendung
  159.      Eine Liste von Dateien (nur beim Start aus einer Shell).  Es
  160.      können die bekannten AmigaDOS Wildcards verwendet werden.  Seit
  161.      Version 1.55 findet Most auch Dateien, deren Namen selbst AmigaDOS
  162.      Wildcards, also zum Beispiel Klammern, enthalten.
  163.  
  164. PORTNAME
  165. ========
  166.  
  167. Verwendung
  168.      Name des globalen ARexx Ports von Most (see Der ARexx Port).
  169.  
  170. Vorgabewert
  171.          MOSTPORT
  172.  
  173. PUBSCREEN
  174. =========
  175.  
  176. Verwendung
  177.      Zur Angabe eines Bildschirms, auf dem Most sein Fenster öffnet.
  178.  
  179. STARTUP
  180. =======
  181.  
  182. Verwendung
  183.      Arexx Skript das beim Starten von Most ausgeführt wird (Achtung:
  184.      Dieses Skript wird auch beim Öffnen jedes weiteren Textfensters
  185.      ausgeführt!!) (see Der ARexx Port).
  186.  
  187.      Alternativ können in die Tooltypes der Text-Icons auch direkt
  188.      ARexx-Befehle geschrieben werden, die dann direkt nach dem Öffnen
  189.      des Textes der Reihe nach ausgeführt werden.
  190.  
  191. WINDOWX
  192. =======
  193.  
  194. Abkürzung
  195.          WX
  196.  
  197. Verwendung
  198.      Zur Angabe der X-Koordinate der Most-Fenster.
  199.  
  200. WINDOWY
  201. =======
  202.  
  203. Abkürzung
  204.          WY
  205.  
  206. Verwendung
  207.      Zur Angabe der Y-Koordinate der Most-Fenster. -1 zentriert die
  208.      Fenster.
  209.  
  210. WINDOWW
  211. =======
  212.  
  213. Abkürzung
  214.          WW
  215.  
  216. Verwendung
  217.      Die Breite der Fenster angeben. Wird ein negativer Wert oder
  218.      Null angegeben, so wird die Breite des Bildschirms kopiert.
  219.  
  220. Vorgabewert
  221.      600
  222.  
  223. WINDOWH
  224. =======
  225.  
  226. Abkürzung
  227.          WH
  228.  
  229. Verwendung
  230.      Zur Angabe der Fensterhöhe. Wird ein negativer Wert oder Null
  231.      angegeben,    so wird die Höhe des Bildschirms (ohne Titel)
  232.      kopiert.
  233.  
  234. Vorgabewert
  235.      400
  236.  
  237. SCREENMODE
  238. ==========
  239.  
  240. Abkürzung
  241.          SM
  242.  
  243. Verwendung
  244.      Der Name einer Bildschirmauflösung, die dem Betriebssystem
  245.      bekannt ist (Most verwendet keine fest einprogrammierte
  246.      Namensliste). Eine Liste dieser Namen sieht man zum Beispiel im
  247.      Fenster des Prefs/ScreenMode Programms. Wird ein gültiger Modus
  248.      angegeben, so öffnet Most einen eigenen Bildschirm (Name: Most),
  249.      auf dem seine Fenster liegen.  Achtung: Je nach Version der
  250.      Monitordateien ändern sich eventuell die Namen der Auflösungen.
  251.  
  252. Beispiel
  253.              SCREENMODE "Pal:HighRes"
  254.  
  255. FONT
  256. ====
  257.  
  258. Verwendung
  259.      Der Name der gewünschten Schriftart für den Text inklusive der
  260.      Endung ".font". Achtung mit Proportionalschriften! Die Größe der
  261.      Schrift kann mit der Option FONTHEIGHT angegeben werden, muß aber
  262.      nicht.
  263.  
  264. Beispiel
  265.              FONT "helvetica.font"
  266.  
  267. FONTHEIGHT
  268. ==========
  269.  
  270. Verwendung
  271.      Hiermit kann die Höhe einer gewählten Schriftart festgelegt
  272.      werden. Wird hiermit die Höhe nicht explizit angegeben, so wird
  273.      die Höhe des Standard-System-Fonts kopiert. Diese Option wirkt
  274.      nur in Zusammenhang mit der Option FONT.
  275.  
  276. APPICON
  277. =======
  278.  
  279. Verwendung
  280.      Das AppIcon von Most wird mit dieser Option angeschaltet.  Wird
  281.      Most mit dieser Option ohne weitere Dateinamen gestartet, dann
  282.      wartet das Programm im Hintergrund und öffnet nur das AppIcon.
  283.  
  284. ICONX
  285. =====
  286.  
  287. Verwendung
  288.      Die X-Koordinate für das APPICON auf der Workbench.
  289.  
  290. ICONY
  291. =====
  292.  
  293. Verwendung
  294.      Die X-Koordinate für das APPICON auf der Workbench.
  295.  
  296. BUFLEN
  297. ======
  298.  
  299. Verwendung
  300.      Hiermit läßt sich die maximale Länge des Lesespeichers angeben.
  301.      Für kleiner Dateien wird nur ein Puffer von der Länge der Datei
  302.      allokiert. Dadurch kann mit sehr großen Puffergrößen erzwungen
  303.      werden, alle Dateien vollständig einzuladen.
  304.  
  305. Vorgabewert
  306.      50 000 Bytes
  307.  
  308. PIPELEN
  309. =======
  310.  
  311. Verwendung
  312.      Most kann auch aus einer Pipe lesen. Normalerweise werden dann
  313.      fest BUFLEN/10 Bytes zum Lesen belegt.  Mit dieser Option kann man
  314.      die Speichergröße für Pipes explizit setzen.
  315.  
  316. Beispiel
  317.              PIPELEN 8192
  318.  
  319. QUOTES
  320. ======
  321.  
  322. Verwendung
  323.      Hiermit wird eine Folge von Trennzeichen definiert. Der Sinn
  324.      dahinter ist die Möglichkeit, mit Doppelklick auf ein Wort, das
  325.      zwischen den hiermit angegebenen Trennern steht, einen Text mit
  326.      dem entsprechenden Namen zu laden. Das ist besonders für
  327.      Programmierer gedacht, die somit leicht die Inklude-Dateien in
  328.      ihren Sourcen anspringen können.
  329.  
  330. Vorgabe
  331.      "'<>(){}[]
  332.  
  333. DIRS
  334. ====
  335.  
  336. Verwendung
  337.      Hiermit können mehrere Pfade angegeben werden, die der Reihe nach
  338.      durchsucht werden, wenn Most nach einem Doppelklick in den Text
  339.      Inklude-Dateien einzuladen versucht (siehe QUOTES). Die einzelnen
  340.      Pfade werden durch das Zeichen | voneinander getrennt.
  341.  
  342. Beispiel
  343.              DIRS "Include:|TexInputs:|LC:Include/"
  344.  
  345. ENDS
  346. ====
  347.  
  348. Verwendung
  349.      Endungen, die automatisch an Inklude-Dateien (der Reihe nach)
  350.      angehängt    werden (vgl. DIRS, QUOTES).
  351.  
  352. Beispiel
  353.              ENDS ".c.h.tex"
  354.  
  355. STACKSIZE
  356. =========
  357.  
  358. Verwendung
  359.      Dient dazu, um dem Editor, der mit dem aktuellen Text gestartet
  360.      werden    kann, eine bestimmte Stackgröße einzustellen. Dies ist
  361.      zum Beispiel    für den Emacs ("Eight Megabytes And Constantely
  362.      Swapping"?) nützlich.
  363.  
  364. Beispiel
  365.              STACKSIZE 50000
  366.  
  367.  
  368. Vorgabe
  369.      8192 Bytes
  370.  
  371. Tastenbefehle
  372. *************
  373.  
  374.    Grundsätzlich werden alle von More her bekannten Tastenkommandos
  375. unterstützt.  Die Befehle unterteilen sich in folgende Bereiche:
  376.  
  377. Scrollen
  378. ========
  379.  
  380. eine Zeile tiefer
  381.          CURSOR RUNTER, ZIFFERBLOCK 2, RETURN, ENTER
  382.  
  383. eine Zeile hoch
  384.          CURSOR HOCH, ZIFFERBLOCK 8, DELETE
  385.  
  386. eine Seite weiter springen
  387.          SHIFT CURSOR RUNTER, SPACE, PAGE DOWN
  388.  
  389. Eine Seite zurück springen
  390.          SHIFT CURSOR HOCH, BACKSPACE, PAGE UP, b
  391.  
  392. Zum Textanfang springen
  393.          HOME, <
  394.  
  395. Zum Textende springen
  396.          END, >
  397.  
  398. Eine Spalte nach rechts
  399.          CURSOR RECHTS, ZIFFERBLOCK 6
  400.  
  401. Eine Spalte nach links
  402.          CURSOR LINKS, ZIFFERBLOCK 4
  403.  
  404. 8 Spalten nach rechts
  405.          SHIFT CURSOR RECHTS
  406.  
  407. 8 Spalten nach links
  408.          SHIFT CURSOR LINKS
  409.  
  410. Zum Spaltenanfang springen
  411.          ZIFFERBLOCK 5
  412.  
  413. Suchbefehle
  414. ===========
  415.  
  416. Bisherigen Suchbegriff weiter suchen (vorwärts)
  417.          n
  418.  
  419. Suchen ohne auf Groß/Kleinschrift zu achten
  420.          .
  421.  
  422. Suchen mit Unterscheidung nach Groß/Kleinschrift
  423.          /
  424.  
  425. Das Suchfenster öffnen
  426.          f, s
  427.  
  428. Laden
  429. =====
  430.  
  431.    Neuen Text laden mit l (Dateiauswahlfenster erscheint).
  432.  
  433. Informationsfenster
  434. ===================
  435.  
  436.    Neben dem üblichen Copyright stehen hier nähere Informationen zum
  437. aktuellen Text: Der Dateiname, die Dateigröße, die Zeilenzahl und die
  438. davon gerade sichtbaren Zeilen, sowie der Name des XPK Packers (oder
  439. einfach nur "---" wenn die Datei ungepackt ist). Hier erscheint auch
  440. entweder die Meldung, daß der Text komplett eingelesen wurde, oder die
  441. Größe des benutzten Lesespeichers.
  442.  
  443.    Das Informationsfenster öffnen Sie mit h.
  444.  
  445. Hilfe
  446. =====
  447.  
  448.    Wenn Sie HELP drücken, wird der AmigaGuide mit der Beschreibung
  449. von Most gestartet. Dazu muß natürlich der AmigaGuide installiert
  450. sein. Wenn Most die amigaguide.library nicht öffnen kann, dann
  451. erscheint stattdessen das Informationsfenster.
  452.  
  453.    Der AmigaGuide sucht seine Dokumente im aktuellen Verzeichnis und in
  454. allen Pfaden, die in der Environment Variablen AmigaGuide/Path
  455. aufgelistet sind.
  456.  
  457. Editieren
  458. =========
  459.  
  460.    Wenn Sie e drücken, wird der Text in einen Editor geladen.  Der
  461. Editor wird asynchron gestartet. Den Namen des Editors erwartet Most in
  462. der Environmentvariablen EDITOR.
  463.  
  464.    Hinweis: Die Stackgröße für den Editors kann über die Option
  465. STACKSIZE eingestellt werden.
  466.  
  467. Beenden
  468. =======
  469.  
  470.    Das Textfenster wird mit ESCAPE, CTRL-C oder q geschloßen.
  471.  
  472. Menus
  473. *****
  474.  
  475.    Es gibt folgende Hauptmenüs in Most:
  476.  
  477. Projekt
  478. =======
  479.  
  480. Neu...
  481.      Öffnet ein neues Fenster und fragt per Dateiauswahlfenster nach
  482.      einer neuen Datei. Wenn der Dateiauswahlfenster abgebrochen wird,
  483.      so wird das Fenster wieder geschloßen.
  484.  
  485. öffnen...
  486.      Per Dateiauswahlfenster den Namen einer neuen Textdatei auswählen
  487.      und in das aktuelle Fenster laden. Die Ausmaße, Koordinaten und
  488.      das Pattern des Dateiauswahlfensters können im Einstellungen
  489.      Menü abgespeichert werden.
  490.  
  491. editieren...
  492.      Startet den Editor mit dem aktuellen Text (per RUN). Der Name des
  493.      Editors muß in der Environment Variable EDITOR stehen, die
  494.      Größe seines Stacks kann mit der Option STACKSIZE eingestellt
  495.      werden.
  496.  
  497. drucken
  498.      Druckt den aktuellen Text über den Systemdruckertreiber (PRT:)
  499.      aus.
  500.  
  501. Info...
  502.      Öffnet ein Informationsfenster, in dem neben dem üblichen
  503.      Copyright einige wichtige Informationen zum aktuellen Text stehen:
  504.      Name, Dateilänge, Zeilenzahl, sichtbare Zeilennummern,
  505.      XPK-Packername und entweder die Meldung, daß der Text
  506.      komplett eingelesen wurde, oder die Größe des benutzten Puffers.
  507.  
  508. Ende
  509.      Beendet den aktuellen Text und -- falls es der letzte Text ist --
  510.      auch ganz Most.
  511.  
  512. Bewegen
  513. =======
  514.  
  515.    Verschiedene Menüpunkte zum zeilen- und seitenweisen Springen im
  516. Text, bzw.  um gezielt die letzte oder erste Seite anzuspringen.
  517.  
  518.    Mit dem Menü "zu Zeile ..." kann man in einem Dialogfenster eine
  519. bestimmte Zeilennummer eingeben, zu der man im Text Springen möchte.
  520. Most ignoriert ungültige Zeilennummern (kleiner 1 oder zu groß).
  521.  
  522. Suchen
  523. ======
  524.  
  525. suchen...
  526.      Das Suchfenster wird geöffnet und aktiviert dessen
  527.      Texteingabefeld.  Bei bereits offenem Suchfenster ist dieser
  528.      Menüpunkt abgeschaltet.
  529.  
  530. vorwärts/rückwärts
  531.      Suchen des eingegebenen Suchtextes in die jeweilige Richtung.
  532.      Beide Punkte sind nur anwählbar, wenn das Suchfenster geöffnet
  533.      ist.
  534.  
  535. Extras
  536. ======
  537.  
  538. Bild neu aufbauen
  539.      Initialisiert die Console neu und baut die aktuelle Seite noch
  540.      einmal vollständig auf.
  541.  
  542. Tabulatorbreite einstellen...
  543.      Öffnet ein Dialogfenter, in dem die Breite der Tabulatoren
  544.      eingegeben werden kann. Normalerweise sind die Tabulatoren alle 8
  545.      Zeichen gesetzt.
  546.  
  547. Skript starten...
  548.      Öffnet einen Dateiauswahlfenster, mit dem ein ARexx Makro
  549.      ausgewählt werden kann, das anschließend ausgeführt wird.
  550.  
  551. Einstellungen
  552. =============
  553.  
  554. sichern
  555.     global
  556.           Speichern der momentanen Einstellungen in Env: und EnvArc: in
  557.           ein Unterverzeichnis Most (das automatisch erzeugt wird).
  558.           Es werden alle von der Kommandozeile bekannten Optionen
  559.           gespeichert.  Zusätzlich werden in einer extra Variablen die
  560.           Maße, die Position und das Pattern des Dateiauswahlfensters
  561.           abgespeichert.
  562.  
  563.     lokal
  564.           Speichern der Einstellungen in zwei lokale Shell Variablen
  565.           namens Most/Most und Most/FileReq (sorry wegen den
  566.           Namen...). Diese Option funktioniert natürlich nur, wenn
  567.           Most von einer Shell aus gestartet worden ist!
  568.  
  569. Das Textfenster
  570. ***************
  571.  
  572. Titelzeile
  573.      Links steht der Dateiname, möglichst weit rechts wird die
  574.      aktuelle Spalten- und Zeilennummer der obersten (sichtbaren) Zeile
  575.      angegeben.  Format:
  576.            <Dateiname>                               <Spalte>/<Zeile>
  577.  
  578. Symbole
  579.      Neben den bekannten Systemsymbolen zum Schließen, Verkleinern usw.
  580.      gibt es drei weitere Symbole am rechten Fensterrand, mit denen im
  581.      Text gescrollt werden kann.  Der Scrollbalken kann sowohl frei
  582.      bewegt, als auch durch hineinklicken seitenweise benutzt werden.
  583.      Die Balkenposition gibt die Position im Text, seine Größe das
  584.      Verhältnis der sichtbaren Seite zum ganzen Text an.  Die beiden
  585.      Pfeilsymbole darunter dienen zum zeilenweisen Auf- und Abscrollen.
  586.  
  587. Maussteuerung
  588.      Wir mit der Maus in das Fenster doppelt geklickt, so wird an der
  589.      entsprechenden Stelle nach einem Dateinamen zwischen den
  590.      konfigurierten Trennzeichen (see QUOTES) gesucht. Ist dort eine
  591.      solche Textstelle vorhanden (z.B. in C-Sourcen ein "#include
  592.      <exec/exec.h>" mit dem Dateinamen exec/exec.h zwischen "<" und
  593.      ">"), dann wird jener in allen konfigurierten Verzeichnissen (vgl.
  594.      DIRS) gesucht und sofern gefunden in einem eigenen Fenster
  595.      angezeigt.
  596.  
  597. Clipboard
  598.      Es kann aus den Fenstern durch das einfache Anklicken des Textes
  599.      und dem anschließenden Bewegen der Maus (ohne den linken Knopf
  600.      loszulassen!) ein Textbereich im Fenster markiert werden. Der
  601.      markierte Textbereich kann dann mit AMIGA-C kopiert werden.
  602.  
  603. AppWindow
  604.      Jedes Most-Textfenster ist ein sogenanntes AppWindow, in das
  605.      jederzeit eines oder auch mehrere Icons gezogen werden können.
  606.      Die erste Datei wird dann in das aktuelle Fenster eingeladen und
  607.      für alle weiteren Dateien werden eigene Fenster geöffnet.
  608.  
  609. Das Suchfenster
  610. ***************
  611.  
  612.    Im Suchfenster kann ein Suchbegriff eingegeben, sowie die drei
  613. Suchoptionen eingestellt werden. Dies geht sowohl mit der Maus als auch
  614. per Tastatur. Die entsprechenden Buchstabenabkürzungen sind in den
  615. Symboltexten unterstrichen.  Außerdem hat man im Suchfenster die
  616. gleiche Funktionalität wie im zugehörigen Textfenster:
  617.  
  618.    - Es sind dieselben Menüs und deren Shortcuts vorhanden. Lediglich
  619.      der Menüpunkt Suchen ist abgeschaltet und dafür die Punkte
  620.      vorwärts/rückwärts suchen zugelassen.
  621.  
  622.    - Neben den speziellen Tastenbefehlen für die Symbole des
  623.      Suchfensters werden alle Tastenbefehle des Textfensters
  624.      weiterhin unterstützt.  Insbesondere kann man also bei
  625.      aktiviertem Suchfenster mit den Cursortasten im Textfenster
  626.      scrollen!!! (Achtung: Das geht nur bei inaktivem Texteingabefeld)
  627.  
  628. Das AppIcon
  629. ***********
  630.  
  631.    Das AppIcon erlaubt zwei Funktionen:
  632.  
  633. Doppelklick
  634.      Ein Dateiauswahlfenster erscheint, in dem eine Datei ausgewählt
  635.      werden kann.  Ist nur noch das AppIcon von Most aktiv (das heißt
  636.      keine Textfenster offen) und wird nun das Auswahlfenster
  637.      abgebrochen, so wird damit Most beendet (vorher kommt natürlich
  638.      noch eine Sicherheitsabfrage)!
  639.  
  640. Icons
  641.      Werden Piktogramme auf das AppIcon gezogen, so werden jene
  642.      angezeigt.
  643.  
  644.    Bemerkungen:
  645.      Most verwendet immer das eigene Piktogramm als APPICON! Ein
  646.      eingebautes Bild bzw. ein explizit angegebenes werden nicht
  647.      angeboten/unterstützt.  Die Koordinaten des AppIcons werden im
  648.      Menü Einstellungen mit abgespeichert. Mit den Optionen ICONX und
  649.      ICONY können explizite Koordinaten angegeben werden.
  650.  
  651. XPK Schnittstelle
  652. *****************
  653.  
  654.    Die Schnittstelle zum XPK Standard ist absolut transparent, um
  655. nicht zu sagen, unsichtbar gehalten. Ist eine Datei mit einem XPK
  656. Packer gepackt und ist das XPK Packet korrekt installiert, so
  657. entpackt Most die Datei automatisch und zeigt sie dann an. Im
  658. Informationsfenster erscheint nun hinter "XPK-Packer:" nicht mehr wie
  659. üblich "---", sondern der Name des verwendeten Packers.  Einzige
  660. Besonderheit: Die Datei wird vollständig eingeladen, ein "Paging"
  661. findet nicht statt!
  662.  
  663.    Trifft Most auf eine mit XPK verschlüsselte Datei, dann öffnet
  664. er erst ein Passwort-Dialogfenster, in dem man sein Passwort angeben
  665. kann. Aber Vorsicht: Man hat nur diese eine Gelegenheit! Gibt man ein
  666. falsches Passwort an, sieht man den verschlüsselten Kauderwelch und
  667. muß den Text erneut laden.
  668.  
  669.    Most kann ohne Probleme auch ohne XPK verwendet werden. Die
  670. xpkmaster.library ist also nicht nötig, um mit Most Texte anzuzeigen.
  671. Ohne sie werden XPK gepackte Texte dann natürlich auch nicht
  672. entpackt...
  673.  
  674. Pipe Verwendung
  675. ***************
  676.  
  677.    Neuerdings unterstützt Most auch Pipes. Diese Option ist aber immer
  678. noch wenig getestet. Bitte meldet mir alle Fehler.
  679.  
  680.    Wurde Most zum Beispiel mit
  681.      type xyz | Most
  682.    gestartet, dann öffnet es ein Textfenster Namens <Pipe Inhalt>
  683. und zeigt den Inhalt der Pipe an. Ist jener kleiner als die
  684. konfigurierte Puffergröße, dann kann ganz normal darin gescrollt
  685. werden (editieren funktioniert aber nicht!). Ist der Puffer zu klein
  686. und scrollt man über den Puffer hinaus, so wird zwar weitergelesen,
  687. ein zurück zum Dateinanfang gibt es jetzt aber nicht mehr. Wie üblich
  688. kann man Most natürlich einen größeren Puffer mitgeben...
  689.  
  690.    Kleine Einschränkungen:
  691.  
  692.    Der Puffer wird mit einer Größe von  BUFLEN / 10 angelegt (wie
  693. soll man einer Pipe entlocken, wieviel sie enthält/enthalten wird?).
  694. Mit der Option PIPELEN kann man explizit die Speichergröße für Pipes
  695. festlegen.
  696.  
  697.        XPK aus einer Pipe ist nicht möglich.
  698.  
  699. Der ARexx Port
  700. **************
  701.  
  702.    Neben dem globalen ARexx-Port MOSTPORT (bzw. der durch die Option
  703. PORTNAME angegebene Name) des Hauptprozesses von Most besitzt jedes
  704. Textfenster seinen eigenen ARexx Port. Um einen spezielles Textfenster
  705. anzusprechen, sendet man an den globalen ARexx Port zuerst den Befehl
  706. GetFileList, der eine Liste aller geöffneten Texte und deren Portnamen
  707. zurückgibt. Anhand jener Liste kann dann das gewünschte Fenster direkt
  708. addressiert werden. Während man an die Ports der einzelnen Fenster
  709. alle Arexx-Befehle senden kann, "versteht" der Hauptport nur die
  710. ersten 6 Befehle GetFileList, GetScreenName, Quit, OpenNew, Set und
  711. Request.
  712.  
  713.    Most setzt in RC eine Fehlernummer von
  714.    *    0, wenn der Befehl korrekt ausgeführt wurde.
  715.  
  716.    *    5, wenn Open oder OpenNew fehlschlugen
  717.  
  718.    *    10, bei Fehlern in den Parametern zu einem Befehl.
  719.  
  720.    *    20, falls ein unbekanntes Befehlswort gesendet wurde.
  721.  
  722.    Folgende ARexx Befehle werden unterstützt:
  723.  
  724. GetFileList
  725. ===========
  726.  
  727. Aufruf
  728.      GetFileList
  729.  
  730. Resultat
  731.      In RESULT wird eine Liste aller vorhandenen Textfenster und ihrer
  732.      Portnamen zurückgegeben. RESULT hat den Aufbau: {<Fenstername>
  733.      <Portname> }^+ (das heißt mindestens einmal aber beliebig viele)
  734.  
  735. Beispiel
  736.              GetFileList
  737.              RESULT: "Most.dok MOST.0 Most.doc MOST.1"
  738.  
  739. GetScreenName
  740. =============
  741.  
  742. Aufruf
  743.      GetScreenName
  744.  
  745. Resultat
  746.          RESULT enthält den Schirmnamen
  747.  
  748. Wirkung
  749.      Liefert den Namen des Bildschirms, auf dem Most den aktuellen Text
  750.      darstellt.
  751.  
  752. Beispiel
  753.              GetScreenName
  754.              RESULT - "Workbench"
  755.  
  756. Quit
  757. ====
  758.  
  759. Aufruf
  760.      Quit
  761.  
  762. Wirkung
  763.      Beendet Most und schließt alle Fenster. Das AppIcon von Most
  764.      wird auch entfernt - sofern vorhanden.
  765.  
  766. Beispiel
  767.              Quit
  768.  
  769. Request
  770. =======
  771.  
  772. Aufruf
  773.      Request TITLE/K/A TEXT/K/A GADGETS/K/A
  774.  
  775. Resultat
  776.          RESULT enthält Nummer des gedrückten Gadgets:
  777.  
  778.     0
  779.           das am weitesten rechts (meist Abbrechen)
  780.  
  781.     1 bis n-1
  782.           die restlichen von links durchnummeriert
  783.  
  784. Wirkung
  785.      Eine einfache Möglichkeit einer Benutzerabfrage per Dialogfenster.
  786.      Titel und Text sind einfache Strings. Mit GADGETS werden die
  787.      Texte der Gadgets angegeben, durch '|' getrennt.
  788.  
  789. Beispiel
  790.              Request TITLE "Test" TEXT "Klaro?" GADGETS "JA|Nein"
  791.              RESULT - 1 wenn JA gewählt wurde, sonst 0
  792.  
  793. Set
  794. ===
  795.  
  796. Aufruf
  797.      Set CASE/S WORD/S BACK/S
  798.  
  799. Wirkung
  800.      Durch das Angeben eines der Schlüsselworte wird die entsprechende
  801.      Option angeschaltet, während die Optionen, die nicht angegeben
  802.      wurden, implizit ausgeschaltet werden. Die Parameter bedeuten
  803.  
  804.     CASE
  805.           casesensitives Suchen an
  806.  
  807.     WORD
  808.           wortweises Suchen an
  809.  
  810.     BACK
  811.           Rückwärtssuchen an
  812.  
  813. Beispiel
  814.              Set WORD ON
  815.              Das wortweise Suchen wird an-, die anderen beiden Suchoptionen ausgeschaltet.
  816.  
  817. OpenNew
  818. =======
  819.  
  820. Aufruf
  821.      OpenNew FILE/K
  822.  
  823. Wirkung
  824.      In ein eigene Fenster einen neuen Text laden. Die Angabe eines
  825.      Dateinamens ist optional. Wird er weggelassen, so wird ein
  826.      Dateiauswahlfenster geöffnet.
  827.  
  828.      Es braucht vorher kein aktuelles Fenster gewählt worden sein.
  829.      Das Kommando kehrt erst zurück, wenn der Text beendet wurde!
  830.  
  831. Beispiel
  832.              OpenNew FILE Most.dok
  833.  
  834. Open
  835. ====
  836.  
  837. Aufruf
  838.      Open FILE/K
  839.  
  840. Wirkung
  841.      In das aktuelle Fenster eine neue Datei einladen. Die Angabe eines
  842.      Dateinamens ist optional. Wird er weggelassen, so wird ein
  843.      Dateiauswahlfenster geöffnet. Das Kommando kehrt erst zurück,
  844.      wenn der Text beendet wurde!
  845.  
  846. Beispiel
  847.              Open FILE Most.dok
  848.  
  849. Close
  850. =====
  851.  
  852. Aufruf
  853.      Close
  854.  
  855. Wirkung
  856.      Schließt das aktuelle Fenster.
  857.  
  858. ToFront
  859. =======
  860.  
  861. Aufruf
  862.      ToFront
  863.  
  864. Wirkung
  865.      Holt das aktuelle Fenster nach vorne, so daß es vollständig
  866.      sichtbar wird.  Dazu wird auch der Bildschirm, auf dem sich das
  867.      Fenster befindet, nach vorne geholt und aktiviert.
  868.  
  869. GetWindowDims
  870. =============
  871.  
  872. Aufruf
  873.      GetWindowDims
  874.  
  875. Resultat
  876.      In RESULT steht <xpos> <ypos> <breite> <höhe>
  877.  
  878. Wirkung
  879.      Liefert die Ausmaße des akt. Fensters in RESULT
  880.  
  881. Beispiel
  882.              GetWindowDims
  883.              RESULT - "40 40 600 180"
  884.  
  885. Edit
  886. ====
  887.  
  888. Aufruf
  889.      Edit
  890.  
  891. Wirkung
  892.      Editieren des Textes des aktuellen Fensters  (Editor starten).
  893.  
  894. Info
  895. ====
  896.  
  897. Aufruf
  898.      Info
  899.  
  900. Wirkung
  901.      Öffnet das Informationsfenster zum aktuellen Text.
  902.  
  903. FirstPage
  904. =========
  905.  
  906. Aufruf
  907.      FirstPage
  908.  
  909. Wirkung
  910.      Die erste Seite des Textes anzeigen
  911.  
  912. LastPage
  913. ========
  914.  
  915. Aufruf
  916.      LastPage
  917.  
  918. Wirkung
  919.      Die letzte Seite des Textes anzeigen.
  920.  
  921. NextPage
  922. ========
  923.  
  924. Aufruf
  925.      NextPage
  926.  
  927. Wirkung
  928.      Nächste Seite des aktuellen Textes anzeigen.
  929.  
  930. PrevPage
  931. ========
  932.  
  933. Aufruf
  934.      PrevPage
  935.  
  936. Wirkung
  937.      Springt zur vorherigen Seite im Text.
  938.  
  939. NextLine
  940. ========
  941.  
  942. Aufruf
  943.      NextLine
  944.  
  945. Wirkung
  946.      Eine Zeile weiterscrollen
  947.  
  948. PrevLine
  949. ========
  950.  
  951. Aufruf
  952.      PrevLine
  953.  
  954. Wirkung
  955.      Eine Zeile zurückscrollen
  956.  
  957. NextColumn
  958. ==========
  959.  
  960. Aufruf
  961.      NextColumn
  962.  
  963. Wirkung
  964.      Eine Spalte nach rechts scrollen
  965.  
  966. PrevColumn
  967. ==========
  968.  
  969. Aufruf
  970.      PrevColumn
  971.  
  972. Wirkung
  973.      Eine Spalte nach links scrollen (bis maximal zum Textanfang)
  974.  
  975. NextTab
  976. =======
  977.  
  978. Aufruf
  979.      NextTab
  980.  
  981. Wirkung
  982.      Um 8 Spalten nach rechts scrollen
  983.  
  984. PrevTab
  985. =======
  986.  
  987. Aufruf
  988.      PrevTab
  989.  
  990. Wirkung
  991.      Um 8 Spalten nach links scrollen (bis maximal zum Textanfang)
  992.  
  993. Goto
  994. ====
  995.  
  996. Aufruf
  997.      Goto LINE/K/N/A COLUMN/K/N
  998.  
  999. Wirkung
  1000.      Als Argument muß eine Zeile und optional kann die Startspalte
  1001.      angegeben werden. Die Zeilennummer wird als neuer Seitenbeginn
  1002.      genommen.
  1003.  
  1004. Beispiel
  1005.              Goto LINE 142
  1006.  
  1007. Search
  1008. ======
  1009.  
  1010. Aufruf
  1011.      Search TEXT/K
  1012.  
  1013. Wirkung
  1014.      Ohne Argument: Das Suchfenster öffnen, bzw. bereits eingegebenen
  1015.      Text weitersuchen
  1016.  
  1017.      Mit Suchbegriff: Als neuen Suchbegriff einsetzen und suchen.
  1018.  
  1019. Beispiel
  1020.              Search TEXT huhu
  1021.  
  1022. Bekannte Fehler
  1023. ***************
  1024.  
  1025.    - Verschiedene Kontrollsequenzen zum Setzen des Cursors sorgen für
  1026.      Chaos in der Anzeige.
  1027.  
  1028.    - Die Pipe Verwendung hat Probleme mit der WShell. Jene scheint immer
  1029.      nur zeilenweise in die Pipe zu schreiben, was Most
  1030.      fehlinterpretiert, da es weniger Daten liest als es wollte
  1031.      (nämlich seinen ganzen Pipe-Puffer voll). Sollte ich bei
  1032.      Gelegenheit mal ändern...
  1033.  
  1034.    - Zumindest zu Most 1.53 wurden mir Enforcerhits gemeldet, die wohl
  1035.      auf ein Überlaufen meines Eingabepuffers zurückgehen. Mit der
  1036.      jetzigen Version konnte ich diesen Fehler nicht mehr
  1037.      reproduzieren, kann ihn aber auch nicht ausschliessen.
  1038.  
  1039.    - Bruno Lacombe hat mir einen Mungwall-Hit von Most 1.53 gemeldet,
  1040.      den ich aber auch nicht nachvollziehen kann. Vielleicht kann mir
  1041.      ein anderer genaueres melden?!?
  1042.  
  1043. Kritiken - Ideen
  1044. ****************
  1045.  
  1046.    Ich erweitere Most eigentlich fortwährend und versuche Fehler so
  1047. schnell wie möglich zu beseitigen. Es gibt auch noch ein paar Ecken
  1048. und Kanten, deren ich mir bewußt bin. Ich kann jedoch nicht
  1049. versprechen, daß ich sie in naher Zukunft beheben werde. Schließlich
  1050. arbeite ich an Most in meiner Freizeit und verdiene kein Geld damit...
  1051.  
  1052.    Nichtsdestoweniger bin ich sehr an Anregungen und auch jeglicher
  1053. Kritik und Bugreports interessiert! Schreibt mir, ruft mich an oder
  1054. kommt vorbei, nur teilt es mit mit :-) Most lebt von Eurer Mitwirkung
  1055. und die meisten Anregungen haben ich auch übernommen!
  1056.  
  1057.    Meine Adresse:
  1058.         Uwe Röhm
  1059.         Wörthstr. 18
  1060.         94 032 Passau
  1061.  
  1062.    EMail:
  1063.         bugs@roemer.deg.sub.org
  1064.  
  1065.    Fido:
  1066.         2:2494/22.5
  1067.  
  1068. aktuelle Version
  1069. ****************
  1070.  
  1071.    Die aktuellste Most Version ist immer per ftp auf
  1072. ftp.uni-passau.de (132.231.1.10) in  pub/amiga/local/UweR  zu
  1073. beziehen. Tip: In dem Verzeichnis pub/amiga/local liegen noch ganz
  1074. andere interessante Programme :-)
  1075.  
  1076.    Ich werde versuchen, die aktuellen Releases immer auf das AmiNet und
  1077. auf "Die Box Passau" (Fido-Mailbox, 2:2494/22.0) hochzuspielen.
  1078.  
  1079. Danksagungen
  1080. ************
  1081.  
  1082.    Inzwischen schreibe ich schon rund zwei Jahre an Most und immer noch
  1083. finden sich alte (und neue) Fehler. Die meisten wären mir selbst
  1084. entgangen, wenn ich nicht so viele Mails von Euch, den Benutzern,
  1085. bekommen würde! Ich kann hier und jetzt nicht alle Namen auflisten,
  1086. will aber zumindest die Emsigsten unter Euch nennen:
  1087.  
  1088.        Karl "Charly" Skibinski, David Göhler, Uli Zukowski, Stefan Sticht,
  1089.        Matthias "Tron" Scheler, Jan Holler, Markus Uhlendahl und Dirk Federlein
  1090.  
  1091.    Wer mit Übersetzungen schickt, sollte dies entweder per Diskette
  1092. tun, oder bei Mails ein gängiges uuencode verwenden!  Mir wurden
  1093. jetzt schon oft Übersetzungen als Mail geschickt, die fehlerhaft
  1094. ankamen. Das muß nicht sein und ist schade um Eure Mühe!  Die
  1095. bisherigen Übersetzungen stammen von:
  1096.  
  1097.    - Volker-Alexander Graf (dänisch)
  1098.  
  1099.    - Frank Geider (französisch)
  1100.  
  1101.    - Francesco Dipietromaria (italienisch)
  1102.  
  1103.    - Magnus Holmgren (schwedisch)
  1104.  
  1105.    - Antonio Joaquin Gomez Gonzalez (spanisch)
  1106.  
  1107.    Zum Schluß ein Dankeschön an Urban für seine Mühe und XPK.
  1108. Und außerdem ein herzliches Dankeschön an alle, die mir Bugreports,
  1109. Vorschläge und natürlich Geschenke geschickt haben!
  1110.  
  1111. Index
  1112. *****
  1113.  
  1114.  
  1115.  
  1116.  XPK                                    XPK Schnittstelle
  1117.  AINSI Sequencen                        Prinzip
  1118.  aktuelle Version                       aktuelle Version
  1119.  AmigaGuide                             Hilfe
  1120.  Anregungen                             Kritiken - Ideen
  1121.  AppIcon                                Das AppIcon
  1122.  AppWindow                              Das Textfenster
  1123.  ARexx                                  Der ARexx Port
  1124.  Aufruf von Most                        Konfiguration
  1125.  Autor                                  Kritiken - Ideen
  1126.  Bewegen                                Bewegen
  1127.  Copyright                              Copyright
  1128.  Danksagungen                           Danksagungen
  1129.  Editieren                              Editieren
  1130.  Einstellungen                          Einstellungen
  1131.  Environment Variablen                  Konfiguration
  1132.  Extras                                 Extras
  1133.  Fehler                                 Bekannte Fehler
  1134.  Fenster                                Das Textfenster
  1135.  Fensterverwaltung                      Prinzip
  1136.  gepackte Dateien                       XPK Schnittstelle
  1137.  Giftware                               Copyright
  1138.  Hilfe                                  Hilfe
  1139.  Ideen                                  Kritiken - Ideen
  1140.  Includedateien anspringen              Das Textfenster
  1141.  Informationsfenster                    Informationsfenster
  1142.  Konfiguration                          Konfiguration
  1143.  Kritik                                 Kritiken - Ideen
  1144.  Makros                                 Extras
  1145.  Markieren                              Das Textfenster
  1146.  Maussteuerung                          Das Textfenster
  1147.  Menus                                  Menus
  1148.  Merkmale                               Konfiguration
  1149.  Paging                                 Prinzip
  1150.  Parameter                              Konfiguration
  1151.  Pipe Verwendung                        Pipe Verwendung
  1152.  Prinzip                                Prinzip
  1153.  Projekt                                Projekt
  1154.  Prozeße                               Prinzip
  1155.  Shell Aufruf                           Konfiguration
  1156.  Skripte                                Der ARexx Port
  1157.  Speicherverwaltung                     Prinzip
  1158.  Suchbefehle                            Suchbefehle
  1159.  Suchen                                 Suchen
  1160.  Suchen                                 Das Suchfenster
  1161.  Suchfenster                            Das Suchfenster
  1162.  Symbole                                Das Textfenster
  1163.  Tastenbefehle                          Tastenbefehle
  1164.  Textfenster                            Das Textfenster
  1165.  Titelzeile                             Das Textfenster
  1166.  ToolTypes                              Konfiguration
  1167.  Variablen                              Konfiguration
  1168.  verschlüsselte Dateien                XPK Schnittstelle
  1169.  Vorgabewerte                           Konfiguration
  1170.  Workbench Start                        Konfiguration
  1171.  
  1172.